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Chapter 1 Introduction 


1.1 General Information 


This manual is intended for the system programmer responsible for implementing EXCOM in 
an external system and for the user of the EXCOM function. 


1.2 Equipment Requirements 


The EXCOM function provides communication between external computers and the 
Controllers. EXCOM lets the external computer read from, and write to, the Data Base, using 
simple commands and a low cost asynchronous serial communication link. The communication 
protocol is easily implemented in any external computer, using normal basic input/output 
facilities. 


Advant Controller 410/450 communicates with the external computer via the asynchronous 
communication module CI531. 


Table 1-1, Asynchronous Communication Module CI531 Data 


Function Characteristics 


Communication mode fixed master - 
slave relationship with the external 
computer as master 


Protocol elements Commands and replies 

Code 7 - bit ASCIl 

Maximum message length 326 characters 

Error control Characterwise parity and (optionally) a 
modulo 256 checksum 

Commands - Read process signal data of type AO, 
Al, Dl or DO 


- Read/write data exchange file, DAT 
and DataSet, DSD 


- Translate symbolic names to numerical 


reference 
Flow control XON/XOFF 
Interface V.24 / RS-232-C 
Transmission mode Asynchronous, full duplex 


Number of data bits 7or8 
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Table 1-1, Asynchronous Communication Module CI531 Data 


Function Characteristics 
Parity None, even, space or mark 
Number of stop bits 1,1.5,2 
Transmission speed 150, 300, 600, 1200, 2400, 4800, 9600 
or 19200 bps 


1.3 Manual Organization 


Chapter 
Configuration/ Runtime 
Introduction Installation A Pines Operation Maintenance | | Appendices Index 
uilding 
General Site Plannin Design Product Preventive 
Information Environmen Considerations Operation Maintenance 
Equipment Setup Capacity & Operating Hardware Not applicable 
Requirements Performance Overview Indicators in this manual 
Shut-down 
Manual | Procedures Application Runtime Error 
Organization aoe Start-up Tutorial Messages 
art-u 
Conventions Procedures Tutorial Operating Fault Finding 
teen Instructions & User Repair 
Related Product. Application 
Documentation Verification Procedures Runtime 
Si Seri a Operation ~~ 
elease ontiguration/ Menus : 
History Application Section 
Building Menus 
Terminology 
Product 
Overview 


User Interface 


Figure 1-1. Manual Organization 
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1.4 Conventions 


The Advant Controller 410/450 and MasterPiece 200/1 are referred to as Controller in this 
document. 


AI, AO, DI and DO files are referred to as process data files. 


1.5 Related Documentation 


The following is a list of related documents. 


Table 1-2. Related Documentation 


Document Name 
Aadvant Controller 410 - User’s Guide 
Aavant Controller 450 - User’s Guide 


Aavant Controller 410/450 Configuration and Programming 


Aavant Controller 410/450 Series Data Base Elements Ref. Manual 


MasterGate 230/1 - Technical Description 


1.6 Release History 


The EXCOM protocol and communication link is implemented in a number of pieces of ABB 
Master process control equipment. The first release of EXCOM was with the MasterPiece 2X0 
and MasterGate 210 versions and, in the mid-80s, with the MasterPiece 200/1 version. 


The ABB Advant Controller 410/450 also supports the EXCOM protocol. The ABB Advant 
Controller 410/450 version of EXCOM is compatible to previous versions of EXCOM on the 
protocol level. The only difference is that the newer version features new hardware with a 
slightly different communication speed capability. 
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1.7 Terminology 


The following terminology is used in this manual: 


EXCOM EXternal COMmunication. 


DSC DataSet Communication 
DSD DataSet Definitions 
DAT Data Exchange file 

Al Analog Input 

AO Analog Output 

DI Digital Input 

DO Digital Output 

AC Advant Controller 

AS Advant Station 

MP MasterPiece 

MG MasterGate 

MB MasterBus 

MMC Man-Machine Communication 
bps bit per second 


V.24/RS-232-C CCITT/EIA standard for interface description of asynchronous data 
communication, see Figure 1-2 and Figure 1-3. 


DTESecondary Transmitted Data 14--- (e) 3 a ee (TD)DTE 
DCETransmitter Signal Element Timing 15--- Oo Oo] 3 Rancive d Data (RD)DCE 
DCESecondary Received Data 16--- (e) © | ---4. Request To Send (RTS)DTE 
DCEReceiver Signal Element Timing 17--- fe) © | ---5. Clear To Send (CTS)DCE 
DTELocal Loopback (LL) 18--- oO © | ---6 Data Set Ready (DSR)DCE 
DTESecondary Request to send 19--- (e) : 
DTEData Terminal Ready (DTR) 20... | @ Q.| ~~! Signal Ground)Common 
QO | ---8 Receive Signal Line Detector (DCD)DCE 
DTERemote Loopback (RL) 21... O --9 +VOLTAGE 
DCERing Indicator (RI) 22... | O 10 - VOLTAGE 
DTE/DCEData Signal Rate Selector 23... fe) O ---11 Unassigned- 
DTETransmit Signal ee dae — fe) i ---12 Secondary Receive Line Signal Detctor DCE 
SSNs 20.2 O fo ---13 Secondary Clear To SendDCE 


Figure 1-2. V24/RS-232-C 25-Pin Contact 
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---1 Data Carrier Detector (DCD)DCE 
---2. Received Data (RD)DCE 


DCEData Set Ready (DSR) 6---| O : 
©] ---3 Transmitted Data (TD)DTE 
O 
O 


DTERequest To Send (RTS) 7---| O 
DCEClear To Send (CTS) 8---| © 


---4 Data Terminal Ready (DTR)DTE 
DCERing Indicator (RI) 9---| © SF eee : 


---5 Ground (GND)Common 


Figure 1-3. V24/RS-232-C Nine-Pin Contact 


1.8 Product Overview 


Using EXCOM, external computers can read and write data in the Controller Data Base, using 
simple commands and a low-cost asynchronous RS-232-C communication link. You can 
connect an external computer directly to the Controller (several if necessary). It can access all 
nodes within the Control Network that can be reached from the Controller via the network. The 
following figure, Figure 1-4, shows some typical examples. 
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External 
EXCOM 
External 
Computer 
EXCOM EXCOM 
MP200/1 AC 410 AC 450 
MasterBus 

MP 200/1 
AS 5000S 


MP 200/1 


EXCOM External 
Computer AS 5000S 


MasterBus 


External 


MP 200/1 


Figure 1-4. EXCOM Configuration 


MasterBus 
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1.9 User Interface 


The following figure shows the data flow between an external computer and a Controller. 


External Computer MP 200/AC 400 


Message Transport Message Transport 


Async. Hand. Async. Hand. 


Figure 1-5. Data Flow between an External Computer and the Controller 
Between an external computer and a Controller system, instructions and data are exchanged by 
means of an asynchronous handler and a standard V.24 (RS-232-C) signal interface. 


The Data Base Elements for configuring the asynchronous communication link in the Controller 
are: 


° CI531 CI531 device file (communication module CI531) 


° XCOM_1 and XCOM_2 RS- 232-C characteristics 
(communication speed, parity a.s.o) 


Data in the Controller are organized in files in a Data Base. The files accessible via EXCOM 


are: 

° DAT Data Exchange file 

° DSD Data Set Description file 
° Al Analog Input file 

° AO Analog Output file 

° DI Digital Input file 

° DO Digital Output file 


AI, AO, DI and DO files are referred to as process data files. 
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External DSD 
Computer DataSet 
Description 


PC-programs yl 


PC-programs 
Commands 
Replies | 
| 


Process Data 
Files 


AI,AO,DILDO 


Figure 1-6. Data Flow in the Controller 


The external computer has access to the process Data Base and the PC-program data exchange 
file in the Controller. The process data files are available for read operations only, while the data 
exchange file is open for write as well as for read operations. The external computer affects the 
process outputs indirectly via a PC-program. The PC-program always has supreme control of 
the process. 


The data exchange file is accessible by direct reference to individual records and also by 
reference to Data Sets. A Data Set is a group of associated records in the data exchange file 
which is referred to by a single reference. 


Data Sets are defined locally in the Controller system. 
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Chapter 2 Installation 


2.1 Site Planning Environment 


You can store the DSCA 114 communication board and DSTC 120 connection unit in 
temperatures between -40 and +70 degrees C. They operate at between +5 and +70 degrees C 
and they have immunity to electrical interference according to SS 4361503, Class 3. 


2.2 Setup 


2.2.1 MasterPiece 200/1, MasterView 800/1 or MasterGate 230/1 


See the following table for the channel utilization for DSCA 114 in MasterPiece 200/1, 
MasterView 800/1 and MasterGate 230/1 products. 


Table 2-1. DSCA 114 Channel Unitization 


Channel MasterPiece 200/1 | MasterView 850/1 | MasterGate 230/1 
CHO PRINT PRINT EXCOM 
CH1 EXCOM PRINT - 
CH2 MV 320 EXCOM ADLP 10 (GCOM) 
CH3 MV 320 EXCOM ADLP 10 (GCOM) 


2.2.1.1 Data Base Element for EXCOM 


Fill in the EXCOM communication parameters in the Data Base Element CAP1.2/XCOM_n. 
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CAP1.2 / XCOM_n 


ExCom P (116.2) 
Addr: 0000 11 


Figure 2-1. EXCOM Data Base Element 
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You must set the parameters SPEED, STOPBITS and PARITY to fit both the external computer 
and the DSCA 114. 


NOTE 


CHLEN (Character length) must always be set to 7 (bits). 


The communication is started as soon as you enter the correct values into the Data Base and: 


° Answer “Y” to the question, “Do you want to activate PRINT/ExCom with these 
parameters?”, 


° Press the INIT button to initialize the CPU or 
° Give an ECONFIG/DICONFIG command. 


Table 2-2. Properties of the XCOM_n Data Base Element 


Terminal 


Terminal 


Value 


Default 


no. name entered by value Descupion 

1 NAME System XCOM_n") |Name of Data Base Element 

10 ACT System/User |0 ACTive 1 = EXCOM restarted 
after an Init or DICONFIG. Can 
only be read by AMPL. 

3 SPEED User 1200 DSCA 114 transmission 
speed 110, 300, 600, 1200, 
2400, 4800, 9600 or 19200 bps 

4 CHLEN System 7 Character length always 7 
bit/character. 

5 STOPBITS | User 1 Number of stopbits can be set 
to 1, 1.5 or 2. 

6 PARITY User EVEN Parity can be set to: NONE, 
ODD, EVEN, SPACE(0) or 
MARK (1). 

(1).n=1 or2 
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2.2.1.2 DSCA 114 and DSTC 120 
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The EXCOM communication uses a V.24/RS-232-C channel on the asynchronous 
communication board DSCA 114 and the connection unit DSTC 120. The ribbon cable to 


V.24/RS-232-C 
(DB 25) 


DSCA 114 


DSTC 120 


88 


0 


Oc 
O 


OO 
6 


O 


58 


(MP 200/1) 
2639 0410-BY 
(MV 850) 


I= Receive Data 
O = Transmit Data 
C = Carrier Detect 
S = Clear To Send 


Figure 2-2. EXCOM Hardware in MP 200/1, MV 800 and MG 230/1 


connect the DSCA 114 and the connection unit DSTC 120 is: DSTK 152 for MasterPiece 200/1 
and 2639 0410-BY for MasterView 850. 
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2.2.1.3 Short Distance Modem 


2-4 


The strapping of the strap group SI on DSCA 114 is always set according to Figure 2-3. 


DSCA 114 
1 0 


ADNKWNK OO 


S1 


Figure 2-3. Strapping of SI on DSCA 114 


When the distance is 15 < L < 300 meters, or if ground potentials differ, between the Master 
equipment and the external computer, you need a modem. The specification for the DSTC X008 
follows: 


Table 2-3. DSTC XO08 Characteristics 


Name 


Characteristics 


Transmission 


Asynchronous, full or half duplex or simplex 


DTE Interface 


EIA RS-232-C, CCITT V.24/V 28, 25-pin D-sub contact 
according to ISO 2110-1980 


Line interface 


+ 10mA tri-state balanced current loop simplex (one twisted pair) 
or duplex (two twisted pair) connection 


Transmission speed 


0 - 38 400 bits/s 


Indicators 


Power, TD, RD, RTS and DCD 


Isolation 


Isolation by opto-coupler on incoming line and transformer to line 


Isolation voltage 


1500 V rms. 


Power supply 


120/230 VAC + 10%, 48-62 Hz 


Ambient temperature 


Operating: 5°-50° C, storage: 5°-70° C 


Environmental class 


G according to ABB 2098 032 
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2.2.2 Advant Controller 410 


2.2.2.1 Data Base Element for RS-232-C 


All of the RS-232-C communication devices are configured via the Data Base Element for 
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CI531. 
RS232_n 
RS232 interface 
(345.1) 
RS232_n 1 |NAME ~~ WARNING | 16 —— 
0 3 | BUS ERR | 17 —__— 
0 4 |STATION ERRTYPE| 9 —— 
0 5 | POSITION 
1 6 | SUBPOS 
1 10) IMPL 
1 11) SERVICE 
CI531 7 | TYPE 
XCOM_I —— 18] CHI 
XCOM_2 — 19| cH? 
Figure 2-4. Data Base Element for RS-232-C Devices 
Table 2-4. Properties for the RS232_n Data Base Element 
aa Terminal name sara Ste Default value Description 
1 NAME System RS232_1 Unique name of Data 
Base Element 
3 BUS Not applicable | 0 Not implemented 
4 STATION Not applicable |0 Not implemented 
5 POSITION System 1 In AC 410, always 1 
6 SUBPOSITION | User 1-4 The terminal can be 
modified during 
configuration mode or 
during Operation mode 
if IMLPL = 0. 
10 IMPL User 1 Set to 0 if the 


submodule is to be 
removed or rearranged. 
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Table 2-4. Properties for the RS232_n Data Base Element 


es Terminal name Poauggee Default value Description 

11 SERVICE User 0 This flag is set to TRUE 
when communication is 
running and set to 
FALSE when 
communication is 
stopped. 

7 TYPE System C1531 Default C1531 

18 CH1 User - Possible strings in 
AC 410: XCOM_1, 
XCOM_2, TERM_2 or 
TERM_1 
AC 450: PRI_01, 
XCOM_1, XCOM_2, 
TERM_1, TERM_2, 
TERM_3 or TERM_4. 

19 CH2 User - Possible strings in 
AC 410: XCOM_1, 
XCOM_2, TERM_2 or 
TERM_1 
AC 450: PRI_01, 
XCOM_1, XCOM_2, 
TERM_1, TERM_2, 
TERM_3 or TERM_4. 

16 WARNING System 0 Warning flag 

17 ERR System 0 Error flag 

9 ERRTYPE System 0 Error type, see Table 
2-5 

Table 2-5. Error Codes from RS-232-C Data Base Element. 
Type Code Interpretation 

erbus 31 Module not found or internal bus error 

erhwid 32 Incorrect hardware identity on module 

erinit 33 Start-up of module failed 

erhw 34 Suspected hardware error 


3BSE 003 835R0001 


EXCOM 
Section 2.2.2 Advant Controller 410 


Table 2-5. Error Codes from RS-232-C Data Base Element. 


Type Code Interpretation 
erswid 35 Incorrect software identity on module 
erifid 36 Incorrect module interface identity 
erslvno 50 Illegal slave number 
erpositi 51 Illegal module position 
erdubpos {52 Module position number already used in the 
Advant Controller 410/450 
erdubslv 53 Two modules have the same slave number 


2.2.2.2 Data Base Element for EXCOM 


The EXCOM communication parameters are to be filled in the Data Base Element 
CAP1.2/XCOM_n. 


CAP1.2 / XCOM_n 


ExCom (116.2) 


Figure 2-5. EXCOM Data Base Element for AC 410/450 


Set the parameters SPEED, STOPBITS and PARITY to fit both the external computer and the 


C1531. 
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The state of the RS-232-C circuits (modem signals) DSR (Data Set Ready), CTS (Clear To 
Send), DCD (Data Carrier Detected) and RI (Ring Indicator) are reflected in the Data Base 
Element for EXCOM, XCOM_n. 


Table 2-6. Properties of the XCOM_n Data Base Element 


Terminal | Terminal Value Default er 
Description 
no. name entered by value 
1 NAME System XCOM_n") |Name of Data Base Element 
10 ACT System/User |0 ACTive 1 = EXCOM restarted 
after an Init or DICONFIG. Can 
only be read by AMPL. 
3 SPEED User 1200 CI531 transmission speed 150, 
300, 600, 1200, 2400, 4800, 
9600 or 19200 bps 
DSCA 114 transmission 
speed 110, 300, 600, 1200, 
2400, 4800, 9600 or 19200 bps 
4 CHLEN System 7 Character length always 7 
bit/character. 
5 STOPBITS | User 1 Number of stopbits can be set 
to 1, 1.50r2. 
6 PARITY User EVEN Parity, can be set to: NONE, 
ODD, EVEN, SPACE(0) or 
MARK (1). 
7 ERR System 0 Error flag 
16 VALID System 0 Valid flag for modem, the 
signals below 
17 DSR System 0 Data Set Ready indicator can 
be 1 or 0. 
18 CTS System 0 Clear To Send indicator can be 
1 or 0. 
19 DCD System 0 Data Carrier Detected indicator 
can be 1 or 0. 
20 Ri System 0 Ring Indicator can be 1 or 0. 
(1).n=1 or2 
NOTE 


CHLEN (character length) must always be set to 7 (bits). 
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The communication is started as soon as you enter the correct values into the Data Base and: 


° Answer “Y” to the question, “Do you want to activate PRINT/ExCom with these 
parameters?”’, 


° Press the INIT button to initialize the CPU or 
° Give an ECONFIG/DICONFIG command. 


2.2.2. Communication Submodule CI531 


The communication submodule CI531 is used for asynchronous RS-232-C/V.24 
communication. The module CI531 has got two communication ports with nine-pin D-sub 
contacts, see Figure 2-6. The Advant Controller 410 uses it for EXCOM communication. You 
can insert the CI531 into any one of the four submodule slots, see Figure 2-7. 


Figure 2-6. CSI531 RS-232-C Submodule 


Strappings 
There are no strappings for CI531. 


RS-232-C indications 


The state of the RS-232-C circuits DSR (Data Set Ready), CTS (Clear To Send), DCD (Data 
Carrier Detected) and RI (Ring Indicator) are reflected in the Data Base Element for EXCOM, 
XCOM_1 or XCOM_2. 
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een) 
a; 


kc) 


x 


The CI531 submodule can be inserted 
in any one of the submodule slots | - 4 
in PM 150. 


External 
Computer 


Length 15 m or less 


Max. 300 m at 19200 Bps 


Modem Modem 


DCTC X008 DCTC X008 


Length 15 m or less ST 


Computer 


Figure 2-7. Advant Controller 410 
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2.2.9 Advant Controller 450 


2.2.3.1 Data Base Element for RS-232-C 


All of the RS-232-C communication devices are configured via the Data Base Element for 
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CI531. The devices can be of type XCOM_n, PRI_O1 or TERM_n. 


RS232_n 


pe OCe 


CI531 


RS232_n 


RS232 interface 


(345.1) 


BUS 


10) IMPL 


: NAME 
2 STATION ERRTYPE 
6 


WARNING 
ERR 


POSITION 
SUBPOS 


11) SERVICE 


7 | TYPE 


XCOM_I — 18] CHI 
XCOM_2 — 19| cH? 


16 ——_ 
17 —— 
9 —— 


Figure 2-8. Data Base Element for RS-232-C Devices 


Table 2-7. Properties for the RS232_n Data Base Element 


aa Terminal name sara Ste Default value Description 

1 NAME System RS232_n Unique name of Data 
Base Element 

3 BUS Not applicable /0 Not implemented 

4 STATION Not applicable |0 Not implemented 

5 POSITION User 0 In AC 450 1-8 

6 SUBPOS User 1tor2 The terminal can be 
modified during 
configuration mode or 
during Operation mode 
if IMLPL = 0. 

10 IMPL User 1 Set to 0 if the 


submodule is to be 
removed or rearranged. 
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Table 2-7. Properties for the RS232_n Data Base Element 


es Terminal name Poauggee Default value Description 

11 SERVICE User 0 This flag is set to TRUE 
when communication is 
running and set to 
FALSE when 
communication is 
stopped. 

7 TYPE System C1531 Default C1531 

18 CH1 User - Possible strings in 
AC 410: XCOM_1, 
XCOM_2, TERM_2 or 
TERM_1 
AC 450: PRI_01, 
XCOM_1, XCOM_2, 
TERM_1, TERM_2, 
TERM_3 or TERM_4. 

19 CH2 User - Possible strings in 
AC 410: XCOM_1, 
XCOM_2, TERM_2 or 
TERM_1 
AC 450: PRI_01, 
XCOM_1, XCOM_2, 
TERM_1, TERM_2, 
TERM_3 or TERM_4. 

16 WARNING System 0 Warning flag 

17 ERR System 0 Error flag 

9 ERRTYPE System 0 Error type, see Table 
2-5 

Table 2-8. Error Codes from RS232_n Data Base Element. 
Type Code Interpretation 

erbus 31 Module not found or internal bus error 

erhwid 32 Incorrect hardware identity on module 

erinit 33 Start-up of module failed 

erhw 34 Suspected hardware error 
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Table 2-8. Error Codes from RS232_n Data Base Element. 


Type Code Interpretation 
erswid 35 Incorrect software identity on module 
erifid 36 Incorrect module interface identity 
erslvno 50 Illegal slave number 
erpositi 51 Illegal module position 
erdubpos {52 Module position number already used in the 
Advant Controller 410/450 
erdubslv 53 Two modules have the same slave number 


2.2.3.2 Data Base Element for EXCOM 


The EXCOM communication parameters are to be filled in the Data Base Element 
CAP1.2/XCOM_n. 


CAP1.2 / XCOM_n 


ExCom (116.2) 


Figure 2-9. EXCOM Data Base Element for AC 410/450 


Set the parameters SPEED, STOPBITS and PARITY to fit both the external computer and the 


C1531. 
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The state of the RS-232-C circuits DSR (Data Set Ready), CTS (Clear To Send), DCD (Data 
Carrier Detected) and RI (Ring Indicator) are reflected in the Data Base Element for EXCOM, 


XCOM_1I. 
Table 2-9. Properties of the XCOM_n Data Base Element 
Terminal | Terminal Value Default er 
Description 
no. name entered by value 

1 NAME System XCOM_n") |Name of Data Base Element 

10 ACT System/User |0 ACTive 1 = EXCOM restarted 
after an Init or DICONFIG. Can 
only be read by AMPL. 

3 SPEED User 1200 Cl531 transmission speed 150, 
300, 600, 1200, 2400, 4800, 
9600 or 19200 bps 

4 CHLEN System 7 Character length always 7 
bit/character. 

5 STOPBITS | User 1 Number of stopbits can be set 
to 1,1.50r2. 

6 PARITY User EVEN Parity, can be set to: NONE, 
ODD, EVEN, SPACE(0) or 
MARK (1). 

7 ERR System 0 Error flag 

16 VALID System 0 Valid flag for modem, the 
signals below. 

17 DSR System 0 Data Set Ready indicator can 
be 1 or 0. 

18 CTS System 0 Clear To Send indicator can be 
1 or 0. 

19 DCD System 0 Data Carrier Detected indicator 
can be 1 or 0. 

20 Ri System 0 Ring Indicator can be 1 or 0. 

(1).n=1 or2 

NOTE 


CHLEN (character length) must always be set to 7 (bits). 


The communication is started as soon as you enter the correct values into the Data Base and: 


° Answer “Y” to the question, “Do you want to activate PRINT/ExCom with these 
parameters?”, 
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° Press the INIT button to initialize the CPU or 
° Give an ECONFIG/DICONFIG command. 


2.2.3. Communication Submodule CI531 


The communication submodule CI531 is used for asynchronous RS-232-C/V.24 
communication. The module CI531 has got two communication ports with nine-pin D-sub 
contacts, see Figure 2-6. The Advant Controller 450 uses it for EXCOM printer or terminal 
(MV 320) communication. You can insert the CI531 in any one of the submodule carrier boards 
submodule slots (SC510, SC520 or SC530), see Figure 2-11. 


F= FAULT LED 
R= RUN 


Figure 2-10. CI531 RS-232-C Submodule 


Strappings 
There are no strappings for CI531. 


RS-232-C indictions 


The state of the RS-232-C circuits DSR (Data Set Ready), CTS (Clear To Send), DCD (Data 
Carrier Detected) and RI (Ring Indicator) are reflected in the Data Base Element for EXCOM, 
XCOM_1. 


2.2.3.4 Submodule Carriers 


You can insert the CI531 submodule in any slot on any board of type SC510, SC520 or SC530. 
The CI531 can run two EXCOM channels simultaneously or one XCOM and one PRINT or 
TERM (MV 320) channel, depending on how you configure the RS232 Data Base Element. 
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External 
Computer 


a 


Length 15 m or less 


Max. 300 m at 19 200 bps Length 15 mor less 
External 


\ Computer 
DCTC X008 DCTC X008 


Figure 2-11. MB 300/300E Hardware in AC 450. 


2.3 Shutdown Procedures 


To stop one (EXCOM) link, set the ACT property in the XCOM_1I or XCOM_2 to zero or false 
and: 


° Answer “Y” to the question, “Do you want to activate PRINT/ExCom with these 
parameters?”, 


° Press the INIT button to initialize the CPU or 
° Give an ECONFIG/DICONFIG command. 


Another way to stop both (EXCOM) links on a CI531 is to go into configuration mode and set 
the IMPL property in the Data Base Element RS232_1 or RS232_2 to zero or false. 
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2.4 Start-up Procedure 


The start-up procedure is as follows: 


1. 


a a) el ee 


Install the hardware, the CI531 module, and, for the Advant Controller 450, the SC510, 
SC520 or SC530 boards, in the CPU rack. 


Make the necessary cable connections with or without a modem. 
Dimension the Data Base. Note this is done in configuration mode. 
Configure the Data Base Element XCOM_1 or XCOM_2. 
Configure the Data Base Element RS232_n. 

Leave the configuration mode. 


Verify that there are no error flags set in any of the Data Base Elements mentioned above. 


2.5 Product Verification 
By checking the Data Base Elements RS232_n and XCOM_1, you can verify the function. 
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Chapter 3 Configuration/Application Building 


3.1 Design Considerations 


3.1.1 General 


EXCOM provides the basic facilities for external computers to communicate with processes in 
an ABB Master system. The purpose of the EXCOM function is to perform read/write 
operations in a Controller data base upon commands issued from an external computer. 


This chapter describes the syntax of command and reply messages with respect to format and 
representation of data. The Controller data base files are described to the extent that they are 

accessible via EXCOM. Finally, the commands provided by EXCOM and the corresponding 

reply are presented. 


3.1.2 Syntax of Message 
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A message is composed of two parts: a header and data. Start the message with a Line Feed 
character and end with a Carriage Return character: 


<LF><header><SP><data part><CR> 


<CR> = carriage return 
<SP> = space (blank) 
<LF> = line feed. 


The same syntax is used in command messages as in reply messages. The messages can only 
hold ASCII characters, see Appendix A ASCII Value Table. 


NOTE 


No lowercase letters are allowed! 
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3.1.3 Header 


3-2 


The header starts in position 2 of the message, immediately after the <LF>- character. The 
header has a fixed format of nine characters. 


Table 3-1. Header Format 


Character 
Position 


Designation 


Description 


1 


direction 


‘<‘ indicates command message, i.e., from 
external computer to MP 200/AC 400. 


‘>’ reply message, from MP 200/AC 400 to 
external computer. 


2-3, 4-5 


network, node 


Network and node numbers, is the address of the 
MP 200/AC400 station. Legal numbers are 
‘00’..’99’. If both network and node = 00, the 
station directly connected is addressed. 


6-7 


Message identifier, two ASCII characters in the 
range 20(H) - 5F(H). This is used as a reply 
identifier by the external computer. The 
identifier given in a command will be returned 
unchanged in the corresponding reply. 


8-9 


command 


or 
condition (in a 
reply message) 


Specifying command 
‘TS’ = Translate Symbol 
‘RD’ = read 

‘WR’ = write 


Two uppercase letters indicating the result of a 
performed command. See each command 
respectively. 


Example 


<110317RD 


>0202.FOK 


The header of a read command to node 3 in the connected network 11. 


Message identity = ‘17’ 


A reply message from network 2, node 2. 


Message identity = ‘.F’ 
Condition code = ‘OK’. 
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3.1.4 Data Part 


The data part of a message is separated from the header by a space character. It may contain one 
or several data items separated by space characters. Each data item is of one of the following 


types: 
32 BOOLEANS 


The 32 Boolean values are represented by the corresponding hexadecimal value. The range 
of values is ‘00000000’... FFFFFFFF’ . 


EXCOM replies with leading zeroes, but the external computer may omit leading zeroes in 
commands. The value must always be preceded by a # character. 


Example: #F34C34AC’ 
16 BIT INTEGER 


The range of values is -32768 .. +32767, represented by a corresponding set of ASCII 
digits. EXCOM truncates leading zeroes. Negative values must be preceded with a sign. 
Positive values may not have a sign. 


32 BIT INTEGER 


The range of values is -2147483648 .. +2147483647, represented by a corresponding set of 
ASCII digits. EXCOM truncates leading zeroes. Negative values must be preceded by a 
sign. Positive values may not have a sign. 


32 BIT REAL 


The syntax of real values follows the rules for standard Pascal. 


EXP. PART 


INT. PART o= DEC. PART Y (£) 


3BSE 003 835R0001 


Cw 
QS 
Figure 3-1. Real Value Syntax Rules 


The total number of digits in intpart and decpart must not exceed six (i.e., seven characters 
including a decimal point). The exponent, if present, must not exceed two digits, so the 
value must always be represented by a maximum of 12 ASCII-characters. The absolute 
range of value is approximately 1.2E-38 to 9.2E18. Values less than (absolute) 1.2E-38 are 
truncated to zero. Infinity, Not-a-Number and illegal values are represented with a string of 
12 asterisks. 


12 BIT STATUS 


This format is used to represent status bits in the process signal files. 
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The 12 bits are converted to a hexadecimal value in ASCII representation. (‘O00” ... “FFF’). 
The value is preceded by a ‘#’ character. Preceding zeroes are not truncated, so the value is 
represented by a fixed format of four ASCII characters including the ‘#’. 


Example ‘#2AC’ which corresponds to the decimal value 684. 


3.1.5 Message with Checksum 


Normally, error detection is limited to the parity check that is performed on each character by 
the communication equipment. However, the external computer can increase the message- 
checking facilities with a checksum control of the message. 


To indicate that a checksum is supplied with a command message, the external computer ends 
the message with the sequence: 


&xy<CR> 
where xy are two ASCII coded hexadecimal digits representing the checksum. 


When EXCOM receives a command message with checksum, it tries to verify the message. If it 
is correctly received, it is accepted; otherwise, it is ignored. 


Reply messages have a checksum when the corresponding command message has one. 


The checksum calculation is made as a modulo 256 addition of the numerical (hex-) values of 
the characters, so the checksum is the eight least significant bits of the total charactersum 
converted to two hexadecimal digits in ASCII representation. The checksum calculation starts 
with the first character of the header (1.e., ‘<‘ or ‘>’) and ends with ‘&’. 


Example {char hex 
‘<* 3C 
‘0’ 30 
‘LY 31 
‘0’ 30 
2 32 
3’ 33 
oH 33 
‘R’ 52 
‘D’ 44 
7 20 (space) 
‘.” 2D (minus sign) 
‘AQ’ 34 
‘yr 34 
‘&’ 26 
sum 2D6 
checksum = D6 (eight least significant bits) 
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3.1.6 Data Base Files 


Data in a Controller system is organized in files in a data base. The files accessible via EXCOM 
are: 


DAT PC data exchange file 
DSD DatSet Description file 
DI Digital Input file 

DO Digital Output file 

Al Analog Input file 

AO Analog Output file 


The DAT file is accessible by read and write commands. The process signal files - DI, DO, AI 
and AO are accessible by read commands only. The external computer can affect process 
outputs only indirectly, via the DAT file and PC-programs. 


The following paragraphs describe the data base files to the extent that they are accessible via 
EXCOM. 


3.1.6.1 DAT - Data Exchange File 
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The DAT file is used to exchange data between PC-programs within one or several Controller 
systems. Each record of the DAT file contains one data item representing either 32 Booleans, 
one 16-bit integer, one 32-bit integer or one 32-bit real. In addition to the value, an identifying 
text string, a type code specifying the data type and some status information is stored. 


DAT is accessible via EXCOM with both read and write commands. Write commands, and 
reply messages to read commands, contain the value in the data part. The value is represented 
with the 32-bit Boolean, the 16-bit integer, the 32-bit integer, or the 32-bit real format described 
in Section 3.1.4, depending on the data type of the value. 
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You can also access the DAT file via Data Sets. A Data Set is a group of records in the DAT file, 
defined in a Data Set definition. It can hold up to 24 references to records in the DAT file. 


DSD FILE DAT file 
Data Set PC-program 
Description 

! | Reference 1 ; | & rp 
Reference 2 


raw) 


23| Reference 23 Leo | 
|__| 


24 Reference 24 


Figure 3-2. Relations between DSD and DAT 


Data Sets are defined locally in the Controller systems by means of MasterAid 215, 
MasterAid 220 or Advant Station 100 Series ES. A Controller can accommodate up to 127 Data 
Set definitions for use with EXCOM. 


When Data Sets are used in read or write operations on the DAT file, the order of occurrence of 
data items in the EXCOM messages is important. This order is determined when the Data Sets 
are defined; it is the same as the order of references from the Data Set definition to the DAT file. 


A record in the DAT file can be valid or not valid. In read operations, and if the DAT is not 
valid, EXCOM treats the record as not accessible. In a successful write operation, EXCOM sets 
the valid flag equal to true. 


A Data Set can be enabled and disabled locally within the Controller. When disabled, EXCOM 
treats the Data Set as if it did not exist and replies with an error message accordingly. 


A Data Set Description (DSD) consists of the following properties: 


Table 3-2. Data Set Definition Properties 


Properties Remark 
NAME Not used by EXCOM 
ACT TRUE/FALSE 
IDENT Data Set identity (-127..-1 for EXCOM). 
NO_BREC Not used by EXCOM 
NO_INT Not used by EXCOM 
NO_INTL Not used by EXCOM 
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3.1.6.2 DI - Digital Input File 


Table 3-2. Data Set Definition Properties 


Properties Remark 

NO-_REAL Not used by EXCOM 

DATA_REF A consecutive number of references, max. 
24, to DAT records in the DAT file. A list 
which is not full ends with a zero reference. 

USER = 2 for EXCOM 

SOURCE Not used by EXCOM 

VALID Not used by EXCOM 

BLOCKED Not used by EXCOM 

NET Not used by EXCOM 

NODE Not used by EXCOM 

SCAN_FTR Not used by EXCOM 

VALID Not used by EXCOM 


The DI file stores information about digital input channels. It is accessible via EXCOM with 
read commands only. Data Sets cannot refer to the DI file. 


The reply message to a read command referring to the DI file contains one data item for each 
record comprising the signal status and value, represented with the 12-bit status format, see 
Section 3.1.4. The bits have the following significance: 


Table 3-3. Digital Input Description 


Bit number See Description 
BO ACT = 1 if the signal is implemented 
Bt ERR = 1 if the signal is erroneous 
B2 UPDATED = 1 if the value is legal 
B3 BLOCKED = 1 if updating is blocked 
B4 MAN_ENTR = 1 if the signal is manually updated 
B5 SELECTED = 1 if the signal is selected for MMC dialog 
B6 Reserved for future use 
B7 Reserved for future use 
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Table 3-3. Digital Input Description 


; Name in eee 
Bit number Data Base Description 
B8 VALUE = 0 if the value is zero, 
=1 if the value is one 
B9 Reserved for future use 
B10 NORM_POS = 0 if VALUE = 0 is normal, 
= 1 if VALUE = 1 is normal 
B11 Reserved for future use 


Bit B8 has the logical state of the input. 


3.1.6.3 Al - Analog Input File 


The AI file stores information about analog input channels. It is accessible via EXCOM with 
read commands only. Data Sets cannot refer to the AI file. 
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The reply message to a read command referring to the AI file contains two data items for each 
record: the signal status and the value. 


The signal status is represented with the 12-bit status format and the value with the 32-bit real 
format, see Section 3.1.4. The status bits have the following significance: 


Table 3-4. Analog Input Description 


Bit number ee Description 
BO ACT = 1 if the signal is implemented 
Bi ERR = 1 If the signal is erroneous (signal error) 
B2 UPDATED = 1 If the value is updated (legal) 
B3 BLOCKED = 1 if updating is blocked 
B4 MAN-ENTR = 1 if the value is manually updated 
B5 SELECTED = 1 if the signal is selected for MMC dialog 
B6 Reserved for future use 
B7 Reserved for future use 
B8 VALUE > H2 = 1 if value is greater than high limit 2 
B9 VALUE > H1 = 1 if value is greater than high limit 1 
B10 VALUE < L1 = 1 if value is less than low limit 1 
B11 VALUE <L2 = 1 if value is less than low limit 2 
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3.1.6.4 Analog Output File 


The AO file stores information about analog output channels. It is accessible via EXCOM with 
read commands only. Data Sets cannot refer to the AO file. 


The reply message to a read command referring to the AO file contains two data items for each 
record: the signal status and the value. 


The signal status is represented with the 12-bit status format and the value with the 32-bit real 
format, see Section 3.1.4. The status bits have the following significance: 


Table 3-5. Analog Output Description 


Bit number Sees Description 
BO ACT = 1 if the signal is implemented 
Bi ERR = 1 if the signal is erroneous 
B2 Reserved for future use 
B3 OUTP_BLK = 1 if the signal is blocked 
B4 Reserved for future use 
B5 SELECTED = 1 if the signal is selected for MMC dialog 
B6 Reserved for future use 
B7 MAN = 1 if the signal is in manual mode 
B8 VALUE = H1 = 1 if the signal has maximum value 
B9 Reserved for future use 
B10 Reserved for future use 
B11 VALUE = LO =1 if signal has minimal value 


3.2 Capacity and Performance 


Capacity and performance is largely dependent on the load of the ABB Master Controllers as 
well as the network. 


3.3 Application Start-up 


3.3.1 ABB Master Station Address 


The ABB Master station address, i.e., the network and node numbers, is specified in the header. 
See Section 3.1.3. 


In command messages, the station address specifies the destination of the message. 
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In reply messages, the station address specifies the source of the message. The destination of 
reply messages is always the external computer sending the corresponding command. 


3.3.2 File Codes 


In commands, files are referenced by file codes. These are: 


° DI=1 
° DO =2 
° AI=3 
° AO =4 
° DAT =5 
° DSD =6 


The DSD (Data Set Definition) file may be referenced in Translate Symbol commands, see 
Section 3.5.1.1 


3.3.3 Record Number 
Records are identified by numbers in ASCII representation (‘1’..°32767’). 


3.3.4 Data Sets 


Data Sets are identified by negative numbers in ASCII representation (‘-127’..’-1’). 


3.3.5 Symbolic Names 


Records in the data base files DAT, DI, DO, AI and AO, and Data Set definitions in the DSD 
file, are identified by symbolic names. However, for performance reasons, you cannot use these 
in EXCOM read and write commands. Instead, EXCOM offers a separate command to translate 
symbolic names into record or Data Set numbers. See Section 3.5.1.1. 


3.4 Tutorial 
Not applicable. 


3.5 Application Procedures 


3.5.1 Command and Reply Messages 


The following subsections describe the commands and corresponding reply messages provided 
by EXCOM. 
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Reply messages can be returned in a different order than the order in which the corresponding 
commands were sent. You are advised to increase the value of the message identifier in the 
message header of every message you send to ensure recognition of the reply messages. 


Commands not recognized or disturbed by transmission errors are ignored by EXCOM. The 
external computer should have some kind of time-out supervision to detect when no reply is 
received. 


3.5.1.1 Translate Symbol 


The translate symbol command provides translation of symbolic record names to record 
numbers. 


Command syntax 
<LF>header<SP>file<SP>recname<SP>recname<SP>....<CR> 
header = nwnnidTS 
file = File code, 1..5. 


recname = symbolic names of records in the file specified by ‘file’, 1..20 ASCII characters, 
no blanks. 


Reply syntax 
<LF>header<SP>recno<SP>recno<SP>....<CR> 
header = nwnnidOK All is well 
>nwnnidWG Warning, some record name was not found 
>nwnnidUF _ Error, the file is not found 
>nwnnidIC Error, illegal command 
recno = Record number corresponding to record name in command 
0 => the record name was not found 
If error (UF, IC) no record numbers are returned. 
Example 


Translate record names “TMP5’, ‘UNKNOWN’ and ‘MESV22’ in the AI file (<CR> and 
<LF> are not shown): 


Command: <000078TS 3 TMP5 UNKNOWN MESV22 
Reply >000078WG 63 03 


Checksum characters may be added as described in Section 3.1.5. 


NOTE 


If you make a Translate Symbol request on a Data Set name, you get the value of 
IDENT as an answer. 
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3.5.1.2 Read File 
The read file command is used to read single or multiple records in the DAT or process I/O files. 
Command syntax 
<LF>header<SP>file<SP>recno<SP>recno<SP>....<CR> 
header = <nwnnidRD 
file = File code, 1..5 
recno = Record numbers of desired records. 


If preceded by a minus sign, the data item means number of consecutive records, starting 
with the record specified by the preceding record number. 


Reply syntax 
<LF>header<SP>data<SP>data<SP>....<CR> 
header = >nwnnidOK All is well 


>nwnnidWG Warning, some record number was not accessible/convertible 
>nwnnidUF Error, the DAT file was not found 

>nwnnidOF Error, too many records specified in command 

>nwnnidIC Error, illegal command 


data = Value of desired records, represented according to type and in the order defined by 
the command 


? => data was not accessible 
*e EK — data was not convertible 


If error (UF, OF, IC) no data is returned 


NOTE 
When file is AI or AO, each record is represented with two data items: one 
carrying the signal status and one carrying the value (see Section 3.1.4). 
Consequently, if an AI or AO record is not accessible, this is indicated with two 
question marks separated by a space. 
Example 


Read from DO file records no 8, 10, 11, 12, 20, 21, 24 (<CR> and <LF> are not shown): 


Command: 
<112399RD<SP>2<SP>8<SP>10<SP>11<SP>12<SP>20<SP>21<SP>24 


Reply: >112399O0K<SP>#001<SP>#001<SP>#001<SP>#021<SP> 
#001<SP>#001<SP>#101 


Checksum characters may be added as described in Section 3.1.5. 
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3.5.1.3 Read Data Set 
The read Data Set command is used to read data from the DAT file by referring to a Data Set. 
Command syntax 
<LF>header<SP>datasetno<CR> 
header = <nwnnidRD 
datasetno = Data Set number, -127..-1 
Reply syntax 
<LF>header<SP>data<SP>data<SP>....<CR> 
header= >nwnnidOK All is well 
>nwnnidWG Warning, some data was not accessible/convertible 
>nwnnidUS Error, the Data Set was not found 
>nwnnidUF Error, the DAT file was not found 
>nwnnidIC — Error, illegal command 


data = Values of desired records, represented according to type and in the order 
defined by the Data Set 


?=>> data was not accessible 
we => data was not convertible 
If error (US, UF, IC) no data is returned 
Example 
Read Data Set 3 (<LF> and <CR> are not shown): 
Command: <010182RD<SP>-3 
Reply: >010182WG<SP>-11<SP>-1.7834E10<SP>45678<SP>**#####* 


Checksum characters may be added as described in Section 3.1.5. 


3.5.1.4 Write File 


The write file command is used to write data to single or multiple records in the DAT file. 


Command syntax 


<LF>header<SP>file<SP>recno<SP>data<SP>recno<SP>data<SP>....<CR> 


header = <nwnnidWR 


file = File code, always = 5 
recno= Record number in DAT file 
data = Data to be written into record with the preceding record number 
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Reply syntax 
<LF>header<CR> 
header = >nwnnidOK All is well 
>nwnnidUF Error, the DAT file was not found 
>nwnnidIR Error, record does not exist 


>nwnnidIF — Error, format of some data does not match data type in DAT 
file 


>nwnnidIC — Error, illegal command 
Example 
Write into the DAT file 3.12159 to record 3, 1C to record 77 and 216573 to record 4 
(<CR> and <LF> are not shown): 
Command:<010133WR<SP>5<SP>3<SP>3.12159<SP>77<SP> 
#1C<SP>4<SP>216573 
Reply:  >0101330K 


Checksum characters may be added as described in Section 3.1.5. 


3.5.1.5 Write Data Set 


The write Data Set command is used to write data to the DAT file by referring to a Data Set. 
Command syntax 

<LF>header<SP>datasetid<SP>data<SP>data<SP>....<CR> 

header = <nwnnidWR 

datasetid =Data Set identity, -127..-1 


data = Values to be written into DAT file records, represented according to type 
and in the order defined by the Data Set 


Reply syntax 
<LF>header<CR> 
header = >nwnnidOK All is well 
>nwnnidUS_ Error, the Data Set is not enabled or does not exist 
>nwnnidUF Error, the DAT file was not found 
>nwnnidIR Error, record referenced from the Data Set does not exist 


>nwnnidIF — Error, format of some data does not match data type in DAT 
file, or number of data items does not match Data Set 


>nwnnidIC — Error, illegal command 
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Example 
Write data to Data Set 112 (<CR> and <LF> are not shown): 


Command: 
<010435WR<SP>112<SP>#0<SP>#0<SP>0<SP>0<SP>0<SP>1.23<SP>0.0 


<SP>14 
Reply: >0104350K 


Checksum characters may be added as described in Section 3.1.5. 


3.6 Configuration/Application Building Menus 


See the appropriate Advant Controller 400 Series User’s Guide for configuration data. 
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Chapter 4 Runtime Operation 


4.1 Product Operation 
Not applicable. 


4.2 Operating Overview 
Not applicable. 


4.3 Runtime Tutorial 
Not applicable. 


4.4 Operating Instructions 
Not applicable. 


4.5 Runtime Operation Menus 
Not applicable. 
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Chapter 5 Maintenance 


5.1 Preventive Maintenance 
Not applicable. 


5.2 Hardware Indicators 
There are two LED indicators on CI531, see Figure 5-1. 


F= FAULT LED 
R= RUN 


Figure 5-1. Hardware Indicators 


5.3 Error Messages 


All system messages generated by the EXCOM tasks CXAFO000 in the Controller use Mtype 30 
in the “standard” ABB Master format, see Figure 5-2. 


003 062 S5*13:25:06 30 21 CXAFOO 0 H xxx Data1 Data2 


Network Slave Time Mtype Task name Address 
Node Mcode 


Datal Data2 


Figure 5-2. System Message 


The only system message generated by EXCOM is: 
Mtype = 30 
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Mcode = 21, addressed node unreachable 
Datal = Destination network 


Data2 = Destination node 


This system message is produced when the EXCOM task does not have contact with the node 
addressed. This message is only produced the first time the node becomes unreachable. 


The messages can be read from the station by connecting a MasterAid 220 or an 
Advant Station 100 Series ES. 


5.3.1 Summary of the EXCOM Protocol Error Handling 


EXCOM ignores the command message if any of the following checks is not successful: 


5.3.2 Flow Control 


5-2 


First character is Line Feed 

Message ends with a Carriage Return 

Checksum is correct, if present 

Network and node characters in header are ASCII digits 
Message length is not out of range 


No error indicated from the device handler. 


EXCOM generates a reply message with an error status if any of the following checks is not 
successful: 


Command code must be any of RD, WR, TS 

Write request only allowed to DAT file 

Number of parameters must be in accordance with syntax 

Format of parameters must be in accordance with syntax 

Referenced logical files must exist 

Referenced record must exist (WR commands) 

The records listed in a DataSet must exist and the property ENABLED must be true 


A command must not generate a reply message with a length greater than the maximum 
message length. 


EXCOM generates a reply message with a warning status and error indications if: 


Referenced value is not accessible (RD and TS commands) 
Referenced value is not convertible (RD commands) 


Referenced record is not valid (RD commands). 


EXCOM sends XOFF when an internal buffer (127 characters) is almost full and it sends XON 
when the buffer is empty. 
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The external computer may send XON when it is ready to receive more data. XON received by 
EXCOM causes EXCOM to continue its output. XOFF received by EXCOM forces EXCOM to 
stop its output. 


Note that the external computer should supervise its transaction and send an XON if the 
supervision expires. 


5.4 Fault Finding and User Repair 
Not applicable. 
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Appendix A ASCII Value Table 


A.1 ASCII Value Table 
An ASCII value table follows. 


Table A-1. ASCII Table 


Hex 0 1 2 3 4 5 6 7 
0 NUL | DLE SP 0 E/@ P é/ p 
1 SOH | DC1 | 1 A Q a q 
2 STX | DC2 ‘ 2 B R b r 
3 ETX DC3 # 3 Cc S c Ss 
4 EOT | DC4 | «/$ 4 D T d t 
5 ENQ | NAK % 5 E U e u 
6 ACK | SYN & 6 F V f V 
7 BEL | ETB . 7 G W g w 
8 BS | CAN ( 8 H xX x 
9 HT EM ) 9 | Y i y 
A LF SUB , J Z j z 
B VT ESC i K [/A k a/{ 
Cc FF FS < L \/O | 6/| 
D CR GS : = M }/A m a/} 
E sO RS > N u/s n u/~ 
F SI US / ? O = O DEL 
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